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GENERAL 


The  MINIGAP  system  allows  a user  to  produce  reports  formatted  to  his 
needs  from  a given  database.  A master  file,  containing  the  data,  and  a 
driver  file,  used  to  specify  how  the  data  can  be  accessed,  must  already 
exist.  These  files  must  have  been  created  in  the  required  format,  (see 
Programmer's  Documentation  Manual:  Master  file.  Driver  file).  An  input 
file  containing  the  report  parameters  must  be  set  up  by  the  user  to 
generate  reports.  This  file  is  used  to  specify  the  structure  of  the 
report,  the  organization/s  involved,  the  time  period/s  involved,  the 
account/s  involved,  and  how  and  where  the  report  should  be  output. 

The  following  section,  "STRUCTURE  OF  REPORT  REQUESTS"  should  enable 
the  user  to  decide  which  report  type  (2,  4,  5 or  11)  is  necessary  to 
generate  the  desired  report.  This  section  will  also  explain  the 
general  requirements  and  structure  of  the  input  file.  It  explains 
which  "line  types"  are  necessary  for  each  report  type,  and  in  what 
order  they  must  be  entered  in  the  input  file. 

The  next  section,  "PARAMETERS"  describes  the  key  parameter  words  and 
their  meanings.  The  formats  required  to  enter  parameter  words,  and  the 
other  "line  types"  of  the  input  file  are  specified  in  the  third  section, 
"SYNTACTICAL  REQUIREMENTS".  There  is  a separate  page  in  this  section  to 
describe  each  "line  type".  This  also  contains  correct  and  incorrect  samples 
for  each  "line  type"  used  in  the  input  file. 

The  last  section  contains  a sample  of  an  input  file  for  each  report 
type,  and  the  corresponding  report. 

The  user  should  create  an  input  file  to  generate  a report  using  the 
editor.  The  user  should  follow  the  structural  and  syntactical  requirements 
(see  STRUCTURE  OF  REPORT  REQUESTS  and  SYNTACTICAL  RL.^UIREMENTS) . The  user 
should  set  the  background  partition  of  the  system  to  at  least  167K.  To  run 
MINIGAP,  the  user  types: 

GAP  (filename) 

where  (filename)  is  the  name  of  the  input  file  created  by  the  user.  The  report/s 
and  diagnostic  messages  will  be  output  to  logical  unit  ^15,  unless  the  para- 
meter OUTPUT  was  assigned  by  the  user  (see  PARAMETERS,  OUTPUT).  If  it  was 
assigned,  the  report/s  will  be  output  to  that  logical  unit,  and  the  diagnostic 
messages  to  logical  unit  ^15.  The  user  should  adjust  GAP. CSS  so  that  the 
logical  unit/s  for  output  (11,  12,  13,  14  and  15)  is/are  assigned  to  the 
desired  devices  or  files  (see  GAP. CSS,  next  page). 
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SECTION  2.  STRUCTURE  OF  REPORT  REQUESTS 


STRUCTURE  OF  REPORT  REQUESTS 


There  are  four  different  general  report  structures  used  with  MINIGAP.  The 
first,  generated  by  REPQ02,  contains  accounts  and  account  computations  in  the 
rows,  with  a column  for  each  organization.  The  entire  report  is  for  one  time 
period.  The  next  report  type,  generated  by  REP004,  is  the  reverse  of  the  type 
2 report.  The  accounts  and  computations  are  in  the  columns,  and  the  rows 
represent  the  organizations.  The  third  report  is  generated  by  REP005.  Each 
column  contains  one  time  period  or  a calculation  involving  time  periods.  The 
accounts  and  account  computations  are  in  separate  rows.  The  entire  report  is 
for  one  organization.  The  last  report,  generated  by  REPQll,  has  a separate 
column  for  each  time  period,  or  time  period  calculation.  Each  row  contains 
data  for  one  organization,  and  the  entire  report  is  for  one  account,  or 
account  calculation. 

An  input  file  used  to  generate  a report  must  specify  the  report  type, 
the  contents  of  the  rows  and  the  columns,  and  how  the  data  will  be  output. 

Each  report  type  requires  slightly  different  input. 

The  first  line  of  each  report  request  must  contain  the  report  type 
(2,  4,  5,  11).  This  should  be  followed  by  all  of  the  key  parameters  (see 
next  section,  PARAMETERS)  the  user  wishes  to  specify.  These  are  followed  by 
a line  of  special  characters,  to  denote  the  end  of  the  parameter  specifications, 
and  then,  the  report  title.  The  time  period/s  involved  is/are  on  the  next 
line/s.  For  all  report  types  except  report  type  2 the  next  lines  specify  the 
column  contents,  followed  by  the  column  titles.  The  column  definitions  are 
not  specified  for  report  type  2.  The  remaining  line/s  of  the  report  are 
used  to  specify  the  account/s  involved.  These  lines  may  also  specify  under- 
lining, paging,  etc.  However,  formatting  specifications  are  meaningless 
for  type  4 and  type  11  reports. 

MINIGAP  can  handle  requests  for  more  than  one  report  at  a time  although 
each  string  of  input  data  for  each  report  must  contain  all  the  information 
necessary  for  that  report.  However,  when  report  requests  are  strung  together 
in  one  input  file,  for  one  MINI  GAP  run,  the  parameter  words  need  not  be  re- 
defined. If  one  of  the  reports  specifies  a given  value  for  a parameter  word, 
it  will  retain  that  value  for  all  succeeding  reports,  unless  specifically 
overridden  in  the  succeeding  reports.  (This  assumes  that  the  succeeding 
reports  are  in  the  same  input  file,  and  therefore,  the  same  MINIGAP  run.) 


STRUCTURE  OF  REPORT  REQUESTS,  CONT. 


The  following  pages  describe  the  line  types  necessary  to  generate  a 
given  report.  The  input  file  for  a given  report  must  contain  the  specified 
line  types,  in  the  specified  order,  as  instructed  by  the  following  pages. 
Since  the  input  for  each  report  type  differs  slightly,  the  structures  are 
defined  separately.  The  section,  "Syntactical  Requirements"  should  be 
consulted  to  determine  the  actual  format  of  the  line  types.  If  more  than 
one  line  of  a line  type  may  be  used,  the  line  type  is  enclosed  in  a box. 
Otherwise,  the  line  type  refers  to  one  line.  For  the  line  type,  "input 
parameters,"  the  section  "PARAMETERS"  should  also  be  consulted. 
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STRUCTURE  OF  REPORT  REQUESTS,  CONT. 


REP002 

REP004 

1. 

report  type 

1. 

report  type 

2. 

input 

parameters 

2. 

_ 1 

input  1 

parameters 

i 

3. 

input  end 

3. 

input  end 

4. 

report  title 

4. 

report  title 

5, 

time  period 

5. 

time  period 

6. 

1 

Accounts,  1 

Computations, 

Formatting 

6. 

column  ! 
specifications 
by  account 

7. 

account 

end 

7. 

column  1 

titles  i 

— represents  one  or  more  lines  with  the  same 
function 


Syntax  of  each  line  type  is  described  in  "Syntactical  Requirements". 


STRUCTURE  OF  REPORT  REQUESTS,  CONT. 


REP005 

1. 

report  type 

2. 

input 

parameters 

3. 

input  end 

4. 

report  title 

5. 

|time  periods 

REPOll 

1. 

report  type 

2. 

[input 

jParameters 

3. 

input  end 

4. 

report  title 

5. 

time  periods 

6.  time  period  end  (only 
used  if  the  number  of 
time  periods  is  less 
than  the  number  of 
columns) 


6.  time  period  end  (only 
used  if  the  number  of 
time  periods  is  less 
than  the  number  of 
columns) 


7.  i^blumn 

'specifications 
by  time  period 


7. 


[col  umn ' 

specifications 
'by  time  period, 


8. 


'column 


[titles 

i 


9.  '^Accounts 

Computations, 
J^ormatting 


8. 


column 

titles 


9. 


Accounts  & I 
Computations  I 


10.  Account  end 


10.  Account  end 


—represents  one  or  more  lines  with  the  same  function 


Syntax  of  each  line  type  is  described  in  "Syntactical  Requirements". 
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PARAMETERS 


There  are  17  parameter  words  presently  being  used.  These  may  be  set  to 
a particular  numerical  value,  with  a particular  meaning.  The  upper  and  lower 
bounds  are  stored  for  each  parameter.  If  either  of  these  boundaries  are 
exceeded,  or  if  the  user  doesn't  specify  a value  for  this  parameter  word,  the 
default  values  are  used.  Since  all  of  the  parameter  words  have  a default 
value,  it  is  not  necessary  to  specify  any  of  these,  unless  desired.  The 
four  characters  enclosed  in  parentheses  beneath  each  v/ord  are  the  characters 
that  must  be  used  to  specify  the  parameter  in  the  input  file. 

The  parameter  words  are  specified  after  the  first  line  (which  specifies 
the  report  type).  The  following  parameter  words  are  now  in  use; 


*1. 

Month 

(Mont) 

This  is  used  to  specify  the  month  number  of  the 
fiscal  year  for  which  data  was  used  in  the  report. 

It  will  be  used  to  print  the  heading  of  the  report. 
This  causes  the  time  period  of  the  report  to  be 
written  on  the  report.  The  user  should  make  cer- 
tain that  this  agrees  with  the  time  period  requested 
via  the  time  period  line  type. 

2. 

Year 

(Year) 

This  is  used  to  specify  the  fiscal  year  for  which 
data  was  used  in  the  report,  (see  month)  Only  the 
last  two  digits  of  the  year  should  be  specified. 

3. 

Columns 

This  is  used  to  specify  the  number  of  columns  in  the 
report.  It  is  not  used  for  type  2 reports. 

4. 

Lines 

(Line) 

This  parameter  is  used  to  specify  the  number  of  lines 
in  the  column  headings. 

5. 

Accuracy 

(Accu) 

This  may  be  equal  to  0,  1,  2 or  3.  It  specifies  the 
number  of  digits  output  to  the  right  of  the  decimal 
point. 

6. 

Spacing 

(Spac) 

This  is  used  to  specify  single  (=1),  double  (=2)  or 
triple  (=3)  spacing. 

**7. 

Level  1 
(Acti ) 

This  is  used  to  specify  the  desired  organization's 
rank  at  level  1 (the  lowest  level).  (If  it  is  set 
to  zero,  all  the  organizations  which  are  members  of 
the  requested  level  2 subtotal  are  output.  If  it 
is  set  to  20,  only  the  level  2 subtotal  is  output.) 

*If  M0NTH=1,  the  first  month  of  the  fiscal  year  will  be  printed  in  the  heading. 
For  example,  in  Fiscal  Year  1976,  the  first  month  was  July,  However,  in  Fiscal 
Year  1977,  the  first  month  was  October. 

**If  all  of  the  "level"  parameters  are  set  to  20,  the  grand  total  of  all  the 
organizations  is  used.  See  "Organization  Structure,"  page  3-5. 


PARAMETERS,  CONT. 


*8.  Level  2 
(Comm) 


*9.  Level  3 
(Thir) 


10.  Scale 
(Seal ) 


11.  Page 
(Page) 


12.  Maxlines 
(Maxi ) 


13.  Input 
(Inpu) 


This  is  used  to  specify  the  level  2 group  of  which  the 
requested  organization  is  a member.  (The  combination 
of  this  number  with  the  level  1 number  must  uniquely 
define  the  desired  organization  or  subtotal.)  If  it 
is  set  to  zero,  all  the  level  1 organizations  which 
are  members  of  the  requested  level  3 subtotal  are  out- 
put. If  it  is  set  to  20,  only  the  requested  level 
3 subtotal  is  output. 

This  may  be  used  to  specify  a third  level  of  organiza- 
tion. If  this  is  set  to  20,  the  third  level  of  organi- 
zation is  ignored.  Otherwise,  it  will  output  uhe 
organizations  which  are  members  of  the  level  3 sub- 
total, within  the  constraints  of  the  level  1 and 
level  2 specifications  (see:  Parameters,  level  1 and 
level  2,  above). 

If  this  parameter  is  set  to  "1",  the  data  is  output 
in  units.  If  it  is  set  to  "1000",  the  data  is  output 
in  thousands.  If  it  is  set  to  "1000000",  the  data 
is  output  in  millions.  These  are  the  only  acceptable 
values  for  this  parameter. 

The  page  numbering  will  begin  with  the  number  assigned 
to  this  parameter,  incremented  by  1.  (Since  the  default 
value  is  zero,  if  this  parameter  is  not  set  by  the 
user,  page  numbering  will  begin  with  "1".) 

This  parameter  is  used  to  specify  the  maximum  number 
of  lines  to  appear  on  one  page  of  a report.  A new  page, 
if  necessary,  will  be  started  after  the  number  of  lines 
output  equals  the  maximum  number  of  lines  (as  specified 
with  this  parameter). 

This  parameter  can  be  used  to  specify  the  logical  unit 
from  which  all  future  input  is  read.  However,  this 
does  not  take  effect  until  it  has  been  read.  The 
specification  of  a report  type  and  the  line  containing 
this  parameter  must,  minimally,  be  contained  on  the 
device  assigned  to  logical  unit  ?1.  In  addition,  the 
file  must  be  assigned  in  "GAP. CSS".  The  only  available 
device  numbers  for  this  are  11,  12,  13  and  14. 


♦If  all  of  the  "level"  parameters  are  set  to  20,  the  total  of  all  the  organizations 
is  used.  See  "Organization  Structure,"  page  3-5. 
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PARAMETERS.  CONT. 


14.  Output 
(Outp) 


15.  Width 
(Widt) 


The  report  itself  will  be  output  to  the  logical 
unit  assigned  to  this  parameter.  If  this  parameter 
is  not  used,  the  report  will  be  output  to  device 
#15,  with  all  MINIGAP  messages.  The  output  file  must 
be  allocated  and  assigned  in  GAP, CSS  to  the  device 
number  assigned  to  OUTPUT.  The  only  available  device 
numbers  are  11,  12,  13  and  14. 

This  parameter  is  used  to  specify  the  width  of  the 
columns.  Each  column  will  be  the  same  width. 


16.  Length 
(Stub) 


This  parameter  is  used  to  establish  the  length  of  the 
row  labels,  in  multiples  of  four  (If  LENGTH  = 9,  the 
row  label  will  contain  space  for  36  characters). 


17.  Cormas 
(Pune) 


If  this  parameter  is  set  equal  to  1,  the  numbers  will 
be  output  with  commas  imbedded.  If  it  is  set  to  zero, 
the  commas  will  be  suppressed. 


RESERVED  PARAMETER  WORDS 


*Naine  of 


Word 

Parameter 

Word 

Default 

Value 

Maximum 

Minimum 

Month 

Mont 

1 

12 

1 

Year 

Year 

76 

85 

75 

Columns 

Colu 

1 

15 

1 

Lines 

Line 

1 

8 

1 

Accuracy 

Accu 

0 

3 

0 

Spacing 

Spac 

1 

3 

1 

Level  1 

Acti 

0 

20 

0 

Level  2 

Comm 

0 

20 

0 

Scale 

Seal 

1 

1,000,000 

1 

Page 

Page 

0 

1,000 

0 

Maximum  lines 

Maxi 

60 

1,000 

1 

Input 

Inpu 

1 

32 

1 

Output 

Outp 

15 

32 

1 

Width 

Widt 

8 

16 

1 

Length 

Stub 

10 

10 

1 

Commas 

Pune 

1 

1 

0 

Level  3 

Thir 

20 

20 

0 

This  chart  specifies  the  bounds  of  the  parameter  words,  and  their 
default  value  if  not  specified,  or  if  the  bounds  are  exceeded. 

*These  are  the  names  used  by  the  user  in  the  input  file. 
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SECTION  4.  SYNTACTICAL  REQUIREMENTS 


1 . Report  Type 

2.  Input  Parameters 

3.  Input  End  | 

4.  Report  Title  ' 

5.  Time  Period  I 

6.  Time  Period  End  j 

7.  Column  Specifications  : 

8.  Column  Title  j 

9.  Formatting  ‘ \ 

10.  Accounts 

11.  Computations  ! 

12.  Account  End  j 


I 

! 


SYNTACTICAL  REQUIREMENTS 


This  section  describes  the  syntax  required  for  the  user  input  file.  The 
section  "STRUCTURE  OF  REPORT  REQUESTS"  explains  the  general  requirements  of 
the  input  file,  and  the  required  order  of  the  items  in  the  input  file.  The 
section  PARAMETERS  describes  the  function  of  the  input  parameters. 

The  syntax  will  be  described  in  two  manners.  A verbal  description  of  each 
line  type  is  used  together  with  a semi-formal  grammatical  representation  of 
each  line  type  as  possible.  Following  the  line  type  descriptions  are  samples 
of  user-input  files  and  copies  of  the  reports  generated  by  them. 

The  following  page  of  definitions  should  be  consulted  to  understand  the 
grammatical  representation  of  each  line.  Any  line  which  begins  with  a semi- 
colon will  be  disregarded.  This  enables  the  user  to  insert  documentation  in 
the  report  definition.  A semi-colon  may  also  be  placed  on  a specification 
line  — anything  following  the  semi-colon  (on  that  line)  will  be  disregarded. 
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ALPHA  : (BLANK)  /A,  B,  C...Z/  (ALPHA)  | 

BLANK  : / / (BLANK) 

♦FORMULA  ; (BLANK)  (SEPARATOR,  (,  ))  /STRING,  INTEGER/  (FORMULA) 

INTEGER  : (BLANK)  /!/  (BLANK)  (+,  -)  /NUMBER/ 

NUMBER  : (BLANK)  /0,  1,  2... 9/  (NUMBER)  i 

QUOTE  : /BLANK/  /'/  (STRING)  /'/  (BLANK) 

♦♦SEPARATOR  : (BLANK)  /'',♦,/,+,-,=/ 

STRING  : (BLANK)  /ALPHA,  NUMBER/  (STRING) 

KEY 

()  encloses  an  optional  set 

//  encloses  a set  of  which  at  least  one  element  is  required  j 

& may  be  used  to  allow  definitions  to  continue  on  the  next  line  j 


NOTE:  None  of  these  symbols  are  themselves  used  by  a user  creating  an  input  ? 

parameter  file,  except  as  noted.  They  are  merely  being  used  in  this  I 

manner  to  describe  the  grammar  itself.  In  addition,  any  commas 

encountered  in  the  grammatical  description  are  not  members  of  the  set  i 

itself,  unless  otherwise  noted.  3 


♦For  every  '('  used,  a corresponding  ')'  must  be  used  on  the  same  line. 
The  '('  and  ')'  are  both  members  of  an  optional  set  in  this  line. 

♦♦The  symbol  '/'  is  a member  of  the  required  set  in  this  line. 
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Report  Type 


This  should  be  the  first  line  of  any  input  file.  It  must  contain  an 
equation  which  sets  a string  equivalent  to  the  number  of  the  desired  report 
type.  The  number  may  also  be  expressed  as  an  arithmetic  expression.  The 
string  should  be  on  the  left  side  of  the  equation,  and  the  number  on  the 
right.  *If  the  number  is  a constant,  it  must  be  preceded  by  an  "!". 

report  type:  (STRING)  /SEPARATOR/  /FORMULA/ 

Correct  Incorrect 


repo  = !2 

areport  = (!5  - !3) 
type  +!2 
reportype  = !2 

The  above  lines  will  identify  the 
report  as  a type  2 report.  The 
insertion  of  blanks  makes  no 
difference  in  the  line.  A compu- 
tation may  be  easily  expressed, 
although  a line  which  is  easily 
clear  to  an  observer  is  recommended. 


repo  = 2 
abc(!5-!3) 
2=  .'report 


The  first  line  will  treat  "2"  as 
a variable,  not  a constant. 

The  second  line  will  request 
report  type  3,  which  is  probably 
not  the  user's  intention. 

The  third  line  would  consider 
"report"  as  a constant,  and 
would  be  senseless. 


Note  also  that  the  preliminary  string  on  the  left  side  of  the  equation  is 
optional . 


*The  only  time  that  a variable  could  be  used  would  be  when  it  has  already  been 
defined.  Since  the  report  type  line  must  be  the  first  line  of  the  report 
generation  input,  a variable  would  only  be  previously  defined  if  the  input 
file  contained  lines  for  generating  at  least  one  other  report  preceding  this 
one.  Using  a variable  would  make  the  report  type  line  harder  to  understand, 
so  is  not  recommended. 
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Input  Parameters 


The  input  parameters  are  specified  consecutively,  starting  in  the  second 
line.  These  are  in  the  form  of  equations,  the  right  side  containing  a constant 
(number  preceded  by  an  '!'),  parameter  variable,  or  arithmetic  expression,  and 
the  left  side  containing  at  least  the  first  four  characters  of  the  parameter 
word.  The  parameter  word  may  always  be  accessed  by  using  its  first  four 
characters. 

input  parameter:  (BLANK)  /the  first  four  letters  of  & 
a parameter  word/  (STRING)  (BLANK)  & 

/=/  (BLANK)  /FORMULA,  the  first  & 
four  letters  of  a parameter  word/  & 

(STRING) 

Correct  Incorrect 


WIDTh  = !8  ; define  width 

ACCU  = 1100 

SCALe  = (110  * ACCU) 

The  width  parameter  will  define  the 
column  width  equal  to  8 characters. 
The  wording  following  the  semi-colon 
will  be  disregarded. 

Although  the  syntax  in  the  line  de- 
fining the  accuracy  is  correct,  100 
will  exceed  the  maximum  bounds  for 
this  parameter,  and  the  default 
value  will  be  used. 

The  third  example  illustrates  the 
use  of  an  arithmetic  formula  to 
define  the  parameter. 


colwidth  = 8 
Accuracy-- !5 
SCALe  = /*ACCU  +110 

The  first  line  does  not  contain  the 
first  four  letters  of  any  parameter 
on  the  left  side.  In  addition,  a 
constant  is  used  which  is  not  pre- 
ceded by  an  ' ! ' . 

The  second  line  would  be  correct  if 
the  were  replaced  with  '='. 

The  '='  is  required  to  equate  the  two 
sides. 

The  third  line  does  not  contain  a 
valid  arithmetic  expression.  If  the 
'/*'  were  eliminated,  the  statement 
would  make  sense.  However,  if  (accu 
+ ! 10)  is  not  a valid  value  for  the 
scale  parameter,  a default  value  will 
be  used. 
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Input  End 


The  line  following  the  input  parameters  denotes  the  end  of  the  input 
parameters.  The  only  requirement  for  this  line  is  that  the  first  non-blank 
character  in  this  line  is  one  of  the  19  special  characters  (as  listed  below). 
The  content  of  the  line  does  not  matter,  as  its  only  purpose  is  to  denote  the 


end  of  the  input  parameter  list. 

♦input  end:  (BLANK)  *,  /,  +, 
(input  end,  STRING) 

Correct 

♦♦end  of  list 
/stop/ 


Each  of  these  lines  will  correctly 
denote  the  end  of  the  parameter  list. 
This  line  must  be  the  line  immediately 
following  the  input  parameter  list. 


“>  )»  (*J*L>  •»  *»  !»  $/ 


Incorrect 

the  end!  1 ! 1 
& stop  now. 
report  title 

The  first  non-blank  character 
must  be  a special  character,  as 
defined  above.  In  these  lines, 
the  first  non-blank  characters 
are,  respectively,  't',  and 
'r'.  None  of  these  characters 
are  included  in  the  special 
character  list. 


♦This  set  includes  a comma,  left  and  right  parentheses,  left  and  right  brackets, 
and  a slash  as  special  characters. 
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The  next  line  in  the  input  file  is  assumed  to  be  the  report  title.  Since 
all  characters  and  symbols  may  be  used  in  the  title,  anything  is  syntactically 
correct.  Only  the  first  36  characters  are  used  for  the  title.  Any  blanks  in 
the  title  will  be  output  as  is  (the  entire  line  may  be  blank). 

report  title:  the  first  36  characters  in  this  line  are  treated  as  the 
title. 


Time  Period 


The  next  line/s  in  the  report  will  specify  the  time  period/s.  Where 
multiple  time  periods  may  be  used,  it  is  incorrect  to  specify  more  time 
periods  than  columns.  The  first  8 characters  of  the  line  must  contain  a 
valid  time  period  name  (8  characters,  including  blanks,  are  required).  The 
next  character  (in  column  9)  must  be  a blank,  'C,  'L',  'M',  'Q‘,  or  'P'. 
These  characters  are  defined  as  follows: 

blank  or  'C  use  cumulative  data 

'L'  use  data  for  the  period  requested,  but 

from  the  base  year 

'M'  use  monthly  data 

'Q'  use  quarterly  data 

'P'  use  data  for  the  period  requested,  but 

from  the  previous  year 

These  definitions  are  based  on  the  time  period  pointers  stored  in  the 
first  record  of  the  master  file.  Check  with  programmer  for  up-to-date  def- 
initions. 

If  the  data  is  to  be  'spread'  over  a period  of  time,  the  letter  'S' 
should  be  placed  in  column  20.  (i.e.,  a year-end  total  could  be  'spread 

over  12  months. ) 

time  period:  /8  characters  of  time  period  name  / / , C,  L,  M,  Q,  P/ 

(10  spaces  followed  by  the  letter  'S'.) 

If  an  incorrect  time  period  is  specified,  the  MINIGAP  run  will  stop,  and 
an  error  message  will  be  printed. 


TIME  PERIOD  END 


The  charts  in  "STRUCTURE  OF  REPORT  REQUESTS"  show  which  report  types 
may  contain  more  than  one  time  period  (5  & II).  If  more  than  one  timV  period 
may  be  used,  but  there  are  fewer  time  periods  than  the  number  of  columns, 
this  line  must  be  inserted  after  the  last  time  period  is  specified.  This 
line  must  be  entered  exactly  as  is. 

time  period  end:  /0999/ 


Correct 


Incorrect 


0999 


anything  else. 


•.f  should  not  be  entered  if  only  one  time  period  is  allowed,  or 

IT  the  number  of  time  periods  in  a multiple-time-period  report  equals  the 
number  of  columns.  Since  MINIGAP  'keys'  on  this  line,  it  should  not  be  used 
except  where  specified  by  the  documentation. 


^nn  sequence  of  the  remaining  items  in  the  user  input  file  differs  accord- 

charts  in  "STRUCTURE  OF  REPORT  REQUESTS"  must  be 
consulted  to  determine  what  items  are  required,  and  in  what  order.  Any  for- 
matting specifications  may  now  be  entered,  positioned  according  to  the  user's 
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COLUMN  SPECIFICATIONS 


The  column  specifications  are  dependent  upon  ordei . The  first  line  in  this 
group  will  define  the  first  (leftmost)  column,  the  second  line  will  define  the 
second  column,  etc.  These  specifications  are  expressed  in  terms  of  an  equation, 
which  requires  the  '='  sumbol  between  the  two  sides.  The  left  side  will  contain 
a string,  which  will  be  set  equivalent  to  the  right  side,  and  can  be  used  sub- 
sequently to  replace  the  terms  on  the  right  side.  If  the  columns  will  contain 
account  data,  :ccount  codes  may  be  used  on  the  right  side.  Any  of  the  arith- 
metic operators  ('•*,+,-,/)  may  be  used  in  the  computation  on  the  right  side. 

Any  constants  must  be  preceded  by  an  exclamation  point.  Any  previously  defined 
variables  (including  the  parameter  words),  may  be  used  on  the  right  side.  If 
the  columns  are  specified  by  time,  the  time  periods  may  be  included  (instead  of 
the  account  codes)  in  the  computation  on  the  right  side.  The  time  periods  on  the 
right  side  must  be  represented  by  a letter  of  the  alphabet.  The  first  time 
period  requested  (as  abovpl  "’ay  be  accessed  by  the  letter  'A',  the  second  time 
period,  by  the  letter  'B',  etc.  One  column  specification  line  should  be  defined 
for  each  column  desired.  The  number  of  columns  desired  should  have  been 
specified  using  the  parameter  'COLUMN'. 


column  specification:  /STRING/  (BLANK)  /=/  /FORMULA/ 

Correct  Incorrect 

columnl  = A-B 

c2  = (1100/1120)  * 1100  (1100/1120  * '.100 

col3  = c2  + 1100  colu  = Z 


The  first  line  will  subtract  the  data  The  first  line  does  not  contain 

for  time  period  'B'  from  the  data  for  3 left  side,  or  the  '='. 

time  period  'A',  and  put  the  result  in  The  second  line  contains  a symbol 

the  column  defined.  (In  this  case,  the  Tor  a time  period  on  the  left  side 

column  defined  v/ould  be  the  leftmost  (these  may  occur  only  on  the  right 

column,  since  this  is  the  first  line  addition,  the  formula 

of  column  specifications.)  The  report  this  line  contains  ^ ( , but 

must  use  time  period  data  for  the  7°^  3 ')  . The  third  line  uses  an 

columns  for  this  line  to  be  correct.  input  parameter  word  on  the  left 

The  second  line  is  correct  if  '1100'  side.  The  letter  Z should  not 

and  '1120'  are  account  codes,  and  the  he  used,  since  there  will  never 

accounts  are  entered  in  the  columns  he  that  many  time  periods, 

for  this  report.  This  will  set  (maximum  number  of  columns  - 15). 

column  2 to  a percentage  (as  directed 
by  the  equation). 

The  third  line  will  take  the  data  to 
be  output  to  column  ?,  add  100  to  it, 
and  store  the  result  iti  column  3. 

Note  that  these  three  lines  should 
not  occur  in  the  same  input  file, 
since  none  of  the  report  types  use 
both  account  data  and  time  period  data 
in  the  columns. 
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Column  Title 


The  column  titles  must  always  follow  Ihe  column  specifications.  The 
titles  will  contain  as  many  lines  as  specified  with  the  LINE  parameter.  The 
complete  title  (all  lines)  for  one  column  must  be  or,  one  line  of  the  input 
file.  The  lines  of  the  title  should  be  separated  by  an  'P'  at  the  end  of  each 

title  line.  The  number  of  characters  in  any  line  of  ihe  title  should  not 

exceed  the  specified  column  width.  If  a line  is  to  be  left  blank,  an  is 
still  needed  to  signify  the  end  of  that  line.  However,  there  must  be  at  least 
one  blank  specified  for  that  line,  or  it  will  not  be  printed  as  a line.  The 

number  of  '@'s  (and  the  number  of  lines)  on  a column  title  input  line  should 

not  exceed  the  number  of  lines  specified  with  the  line  parameter.  The  'P' 
is  not  needed  to  end  a line  of  the  column  title  if  the  number  of  characters  in 
the  column  title  is  equal  to  the  column  width.  Each  line  of  the  title  will  be 
centered;  this  may  be  overridden  by  inserting  blanks,  as  desired,  in  the  lines 
of  the  column  title. 

column  title:  /one  line  of  column  title,  not  to  exceed  column  width/  & 
(P)  (column  title) 

Assume  LINE  = !4  and  WIDTH  = !8  for  the  following  examples. 

Correct  Incorrect 


cumPamountPyr  endP1976  cum  amount  yr  end  1976P 

This  will  generate  the  following  Although  this  is  syntactically  correct, 

title:  it  will  not  generate  the  same  title  as 

the  'correct'  example.  The  title  v/ould 
cum  be  output  as  follows: 

amount 
yr  end 
1976 


cum  amou 
nt  yr  en 
d 1976 


FORMATTING 


There  are  three  types  of  formatting  specifications.  If  the  first  four 
characters  in  a line  are  'PAGE',  a new  page  of  the  report  will  be  started 
before  any  more  ines  are  output.  If  the  first  four  characters  are  ' ' 

^^^enerated  for  that  row,  under  the  row  labels  and 
under  each  column.  If  the  first  four  characters  are  '====',  a double  hashed 
line  generated  for  that  row,  in  the  same  manner  as  the  single  hashed 


formatting:  /PAGE,  , ====/  (BLANK) 

Correct 


PAGE 


These  lines  must  each  start  in  column  1, 
and  are  the  only  correct  lines  of  format- 
ting. These  may  be  inserted  on  any  lines 
after  the  time  period  specifications, 

(or  after  column  titles,  as  appropriate). 
After  a formatting  specification  line,  no 
lines  are  output  to  the  report  until  the 
formatting  has  been  done. 


Accounts 


The  lines  used  to  specify  accounts  require  strict  formatting.  The  first 
four  columns  '’'ust  contain  the  4 character  account  code.  The  next  column  must 
be  left  blank.  The  sixth  column  may  contain  one  digit,  used  to  express  the 
number  of  spaces  the  row  labels  should  be  right-justif ied  in  multiples  of  4 
(i.e.,  if  the  digit  = 3,  12  spaces  will  be  inserted  to  the  left  of  the  row 
labels).  The  next  two  columns  may  be  used  to  specify  vertical  tabbing.  Any 
blanks  contained  in  columns  7 and  8 will  be  treated  as  zeroes.  The  number  of 
lines  skipped  will  equal  the  2 digit  number  which  the  user  inserts  in  these  tv/o 
columns. 


accounts:  /four  character  account  code/  ( M(VV)  ) 

where  H=  an  optional  1 digit  number  representing 
horizontal  tabbing  in  multiples  of  four 


Correct 


VV=  2 digit  number  representing  the  number  of 
vertical  tabs,  also  optional 

Incorrect 


1130  5 2 


11305  2 


This  line  directs  MINIGAP 
to  output  the  data  for 
account  1130,  tabbing 
20  spaces  (5*4  spaces) 
to  the  right,  and  inserting 
2 blank  lines  before  this  line 
is  printed. 


The  fifth  column  should  be  left  blank, 
and  this  would  direct  MINIGAP  to  output 
20  blank  lines  before  printing  this 
line.  (Outputting  20  blank  lines  is 
permissable,  but  may  not  be  what  is 
intended  by  the  user.) 


COMPUTATIONS 


An  computations  (except  column  computations  which  are  expressed  in  the 
column  specification  lines)  must  be  preceded  by  a 'COMP'  statement.  This 
line  must  contain  'COMP'  in  the  first  four  columns.  If  any  tabbing  is  re- 
quired, it  should  be  specified  in  the  same  manner  and  same  columns  as  tabbing 
for  accounts,  (see  previous  page,  'Accounts'.) 

The  actual  computation  must  be  contained  on  the  next  line.  The  format 
used  for  computation  specifications  is  similar  to  the  format  used  for  column 
specifications.  Hov/ever,  a title  for  the  computation  (to  be  used  as  a row 
label,  in  the  same  manner  as  the  account  names)  can  be  specified  by  enclosing 
the  title  in  single  quotes,  following  at  least  one  blank  after  the  computation. 

computations— 1 : /COMP/  ( H(VV)  ) 

where  H=  an  optional  1 digit  number  representing 
horizontal  tabbing  in  multiples  of  four 

VV=  2 digit  number  representing  the  number 
of  vertical  tabs,  also  optional 

computations--2;  /STRING/  (BLANK)  /SEPARATOR/  /FORMULA/  (QUOTE) 

Correct  Incorrect 


COMP  1 2 

var  = 8200  - 8230  'cost  variance' 

COMP 

var2  = 8400  - 8430  'price  variance' 
COMP  2 2 

nuvar  = var2  - var  'new  variance' 

Each  of  the  above  lines  calculates 
an  account  computation.  The  numbers 
•8200',  '8230',  '8400'  and  '8430'  are 
account  codes.  If  the  numerical 
value  for  these  numbers  was  desired, 
they  would  have  been  preceded  by 
an  ’!'.  Note  that  the  'string'  on 
the  left  side  of  the  first  and  second 
equations  has  been  used  to  replace 
the  right  side  of  the  equations  for 
use  in  the  last  equation. 


var  = 8200  - 8230  'cost  var' 

COMP 

var2  = var*  110.5  'calc  var' 

COMP  2 10 
nu  var  + oldvar 

The  first  line  is  incorrect,  because 
it  must  be  preceded  by  a 'COMP' 
statement. 

The  second  set  of  lines  may  be  incorrect 
on  some  machines.  If  the  '110.5'  is 
replaced  with  '1105/110',  no  syntax 
error  will  be  generated,  and  the  result 
will  be  the  same  on  all  machines.  (Some 
machines  may  not  be  able  to  compute 
equations  containing  real  numbers.) 

The  third  set  of  lines  does  not  contain 
a valid  arithmetic  statement.  If  a 
'STRING'  was  set  equal  to  the  sun,  the 
line  would  be  correct.  In  addition, 
there  would  be  only  one  line  of  vertical 
tabbing,  since  the  2 digit  number  must 
be  contained  in  columns  7 and  8. 
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SECTION  5.  SAMPLES 


t 


SAMPLE  1 

‘input  file  for  type  2 REPORT 


REPORTYPE= !02 
0UTPIJT=  ! 14 
ACCURACY=  !0 
SCALE  =!1 
PUNCTIJATION=  ! 1 
STIJB=  ! 7 
PAGE= !00 
COMMAND= !6 
WIDTri=  • 12 
YEAR= ! 76 
MONTH= ! 12 
************* 
SAMPLE  OF  TYPE  2 
NRG  7612C 
3200  1 1 
3210  1 
8220  1 
8230  1 
3240  1 
3250  1 


3260 
3205  1 1 
COMP  1 

DD= <8215#  ! 1 16) / ! 10  'ELECTRICITY  MBTU’ 

3225  1 

3235  1 

8245  1 

8255  1 

3265 

0999 


fIJSE  COMMAS 

;ALL0W  28  CHARS.  FOR  ROW  LABELS 
JSTART  WITH  PAGE  1 


rYEAR  AGREES  WITH  TIME  PERIOD 
fMONTH  AGREES  WITH  TIME  PERIOD 


fFORMATTING 


fFORMATTING 
;END  OF  REPORT 


6 
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SAMPLE  1 

REPORT  GENERATED 
BY  TYPE  2 INPUT  FILE 


DATE:03/20/78  PAGE  1 

NCD-5  REPORT  GENERATOR 

SAMPLE  OF  TYPE  2 

FOR  PERIOD  ENDING  30  JUNE  1976 


ACCOUNT 

PWCPERLH 

PWCPERLC 

PWCPERLP 

8200 

FUEL  OIL  COST 

644 » 850 

30,737 

675,537 

8210 

ELECTRICITY  COST 

3»019» 186 

155.726 

3.174,912 

8220 

COAL  COST' 

0 

0 

0 

8230 

NATURAL  GAS  COST 

0 

0 

0 

8240 

PROPANE  COST 

504.588 

28.892 

533.430 

8250 

STEAM  COST 

0 

0 

0 

8260 

TOTAL  FUEL  COST 

4,168.624 

215.355 

4.383.979 

8205 

FUEL  OIL  MBTU 

264.387 

12.805 

277.192 

ELECTRICITY  MBTU 

1 .235.412 

63.417 

1.298.329 

8225 

COAL  MBTU 

0 

0 

0 

8235 

NATURAL  GAS  MBTU 

0 

0 

0 

8245 

PROPANE  MBTU 

109.002 

6.746 

115.748 

8255 

STEAM  MBTU 

0 

0 

0 

8265 

TOTAL  FUEL  MBTU 

1.608.800 

82.968 

1.691.768 
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SAMPLE  1 

.MESSAGES  OUTPUT  TO  UNIT  15 


«««««FPD001 
««««*FPO00 
«*«««FPD00 !««*** 


♦♦♦♦♦COMPIL***** 

»#**»FPDREP*'**** 

##**-*COMPIL»**** 

»»***COMPIL***** 

#**#*COMPIL*-*»*» 

HHHf**COMPIL**»** 

♦♦*#*COMPIL**»** 

»**»#COMPIL***** 

♦ ♦♦♦♦COMPIL***-** 

♦♦♦♦♦COMPIL***** 

♦ ♦♦♦♦COMP  I L *■**♦* 
♦♦♦♦♦COMPIL^**^^ 
♦♦♦♦♦GETDAT^^^^^ 

♦ ♦♦♦♦COMP  I 


♦ ♦♦♦♦FPDREP^**-** 


SYMBOL  TABLE  STORAGE  BEGUN 
59  ACTIVITY  NAMES.  UICS.  KEYS 
52  FPD  ACCOUNT  SYMBOLS.  NAMES 
SYMBOL  TABLE  STORAGE  COMPLETE 


REPORTYPE= !02 

REPORT  # 1.  REPORT  TYPE  2 


OUTPUT= ! 14 
ACCURACY=  !0 

SCALE  = ! 1 
PUNCTUATION= ! 1 
STUB=!7 

PAGE= !00 

.USE  COMMAS 

; ALLOW  28  CHARS.  FOR  ROW 
JSTART  WITH  PAGE  1 

COMMAND= !6 

WIDTH= ! 12 

YEAR= ! 76 

MONTH= ! 12 
♦♦♦♦♦♦♦♦♦♦♦♦ 

NRG  7612  FY76 

JUN 

C 

;year  agrees  with  time  p 

.MONTH  AGREES  WITH  TIME 

DD= (8215^ ! 1 16) / ! 10 

'ELECTRICITY  MBTU’ 

END  OF  REPORT  PROCESSING 
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SAVPLE  2 

INPUT  FILE  FOR  TYPE  4 REPORT 


REPORTYPE=!04 
COLUMNS= !5 
LINES= !02 
ACCURACY= !00 
SCALE  = ! 1 
COMMANDS !0 
THIRDS  ! 1 
ACTIVITYs  >20 
OUTPUTS ! 14 
WIDTHS  ! 10 
PUNCTs !00 
SPACING=!01 
YEARS !76 
MONTHS ! 12 
» 

SAMPLE  OF  TYPE  4 
NRG  7612C 
C1S8205 
C2s8215 

C3=8215*! 116/ ! 10 

C4=8235 

C5s8265 

FUELQMBTUe 

ELEC0KWH0 

ELEC@MBTU0 

NAGSMBTUe 

TOTALSMBTUe 


; PR  I NT  5 COLS. 

;z  LINES  OF  HEADINGS 
;N0  DECIMAL  PTS. 

;iN  UNITS 

fFOR  ALL  LEVEL  2 GROUPS 
;F0R  LEVEL  3f  GROUP  1 
;F0R  SUBTOTALS 

; SEPARATE  REPORT  FROM  MESSAGES 
fCOLUMN  WIDTH 

;no  commas 

; SINGLE  SPACE 
fDATE  OF  DATA 

?END  OF  PARAMETERS 
r TITLE  OF  REPORT 
fNAME  OF  DATA  TYPE 
; ACCOUNTS 

; CHANGE  KWH  TO  MBTU 


.COLUMN  TITLES 


SAMPLE  2 

REPORT  GENERATED  BY  TYPE  4 
INPUT  FILE 


DATE:04/10/78  PAGE  1 

NCD-5  REPORT  GENERATOR 

SAMPLE  OF  TYPE  4 

FOR  PERIOD  ENDING  30  JUNE  1976 


ACTIVITY 


PWCNORFP 


PWCPENSP 


PWCGRLKP 


PWCSANDP 


PWC3ANFP 


PWCPERLP 


PWCGUAMP 


PWC  SUBP 


PUC  TOT 


FUEL 

ELEC 

ELEC 

NAG 

TOTAL 

MBTU 

KUH 

MBTU 

MBTU 

MBTU 

4644415 

439671 

5100184 

270894 

10015492 

64(368 

109098 

1265537 

2805866 

4135574 

12718 

106406 

1234310 

2931262 

4178289 

1431177 

441949 

5126608 

955701 

7990128 

295284 

203808 

2364173 

2225788 

4885244 

277192 

1 11968 

1298829 

0 

1691768 

133256 

274008 

3178493 

0 

3311747 

1161416 

128273 

1487967 

0 

2649383 

8019526 

1815181 

21056096 

9189511 

38857616 

SAMPLE  2 

MESSAGES  OUTPUT  TO  UNIT  15 


I 

I ***»FPD00 !*»»»*  SYMBOL  TABLE  STORAGE  BEGUN 
innm»FPD001*****i59  ACTIVITY  NAMESf  UICS.  KEYS 
**hhi»FPD001****#  52  FPD  ACCOUNT  SYMBOLS*  NAMES 
j**»»FPD00Hnnnnt  SYMBOL  TABLE  STORAGE  COMPLETE 


|HHf##COMPIL*-»##*  REPORTYPE=  ! 04 

U*##FPDREP#****  REPORT  # 1*  REPORT  TYPE  4 

innnntCOMPIL*****  COLUMNS  = ! 5 
|*#-»»COMPIL#*-»#-»  LINES=!02 
I »-»»#COMPIL-»*-»**  ACCURAC  Y=  ! 00 
•innnnfCOMP IL*#***  SCALE  =!1 

• •♦♦♦COMPIL-*****  COMMAND=!0 
s^*»*COMPIL*'*-»#*  TH1RD=!1 

. .t***COMPIL*»#**  ACTIVITY=  ! 20 
■»-**»*COMP  IL***»*  OUTPUT  = ! 1 4 

• t**-*COMPIL-»**»*  WIDTH=!10 
■ t-^intCOMPIL-**-*-**  PUNCT=!00 
♦♦♦♦♦COMPIL*****  SPACING= ! 01 
' " innfCOMP  IL*###*  YEAR=!76 

4 ■•♦♦COMPIL**#**  M0NTH=!12 
«***-*COMP  IL*****  f 

♦♦***GETDAT#*4##  NRG  7612  FY76  JUN  C 

•>  ♦»-»COMPIL**-»»*  Cl  =3205 

* »»*COMPIL##*»*  C 2=82 15 
*#»##COMPIL#*-»*#  C3  = S215#  ! 1 16  / ! 10 
^ ♦♦♦COMP IL##-*#*  C4  = 3235 

* **»COMP I L#****  C5=3265 
***»*RDTITL*»***  FUELraMBTUO 

♦ •=*-**RDT I TL*»***  ELECI?MBTUI?^ 

* ■»-*«RDTITL*#*-*»  ELECNMBTljra 
«-r*«»RDTITL*-»***  NAGSMBTUO 
innnntRDTITL*****  TOTAL@MBTU@ 


# *#HfFPDREP»»»*»  END  OF  REPORT  PROCESSING 
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; PR  I NT  5 COLS. 
f2  LINES  OF  HEADINGS 

;no  decimal  pts. 

; IN  UNITS 

;F0R  all  LEVEL  2 GROUPS 
rFOR  LEVEL  3*  GROUP  1 
fFOR  SUBTOTALS 
i SEPARATE  REPORT  FROM  ME 
i COLUMN  WIDTH 
fNO  COMMAS 
; SINGLE  SPACE 
;DATE  OF  DATA 

5END  OF  PARAMETERS 

; ACCOUNTS 

; CHANGE  KWH  TO  METU 


.•COLUMN  TITLES 


SAMPLE  3 

INPUT  FILE  FOR  TYPE  5 REPORT 


REP0RTYPE=!5  {REPORT  TYPE  LINE 

WIDTH=!09  {PARAMETER  LINES 

COLUMNS= ! 03 

LINES=  !4 

LINCOIJNT=  ! 00 

MAXL1NES=!66 

ACCURACY= !0 

SCALE  =!1000 

PAGE= !00 

OUTPUT = ! 14 

C0MMAND=!9 

ACTIVITY=!20 

THIR=!1 

SPACING= ! 01 

YEAR=  ! 0 

MONTH= ! 03 


SAMPLE  OF  TYPE  5 

NRG  7503C 

NRG  7T03CUMU 

0999 

C1=A 

C2  = B 

C3  = A-B 

CUMliAMTSlST  QTR@1975e 
CUMSAMTeiST  QTR(1197T@ 
e @ @VARIANCE 
COMP  1 

00  = 8200/8260*  ! 100  'PERCENT 
8200  1 
8210 
8220 
8230 
8240 

8260 

0999 


{REPORT  TITLE 
{TIME  PERIOD  (A) 

{TIME  PERIOD  (B) 

{TIME  PERIOD  END 
{COLUMN  SPECIFICATIONS 


{COLUMN  TITLES 


{COMPUTATION 
OIL  OF  TOTAL' 
{ACCOUNTS 


{FORMATTING 
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SAMPLE  3 

REPORT  GENERATED  BY 
TYPE  5 INPUT  FILE 


DATE:03/20/78  PAGE  1 


NCD-5  REPORT  GENERATOR 

SAMPLE  OF  TYPE  5 

FOR  PERIOD  ENDING  30  SEPTEMBER  1975 
(AMOUNTS  IN  THOUSANDS) 

PWC  TOTAL  ACTIVITIES 

CUM 

AMT 

1ST  QTR 
1975 

CUM 

AMT 

1ST  QTR 
197T 

VARIANCE 

PERCENT  FUEL  OIL  OF  TOTAL 

30 

16 

14 

8200 

FUEL  OIL  COST 

5 f 6 1 3 

3,123 

2,490 

8210 

ELECTRICITY  COST 

10i802 

14,180 

-3,378 

8220 

COAL  COST 

0 

0 

0 

8230 

NATURAL  GAS  COST 

2,100 

2,239 

-139 

8240 

PROPANE  COST 

55 

140 

-85 

8260 

TOTAL  FUEL  COST 

18,726 

19,951 

- 1 , 225 

SAMPLE  3 

MESSAGES  OUTPUT  TO  UNIT  15 


**##FPD001#*»*»  SYMBOL  TABLE  STORAGE  BEGUN 
U»**FPD001*****159  ACTIVITY  NAMES»  UlCSr  KEYS 
♦**##FPD00Hnnnn»  52  FPD  ACCOUNT  SYMBOLSi  NAMES 
’***#FPD001*»*«*  SYMBOL  TABLE  STORAGE  COMPLETE 


•■•HnnfCOMPIL*#*#* 
****FPDREP##*** 
* 4hhhh:0MP  I L » ♦ * * # 
*****COMPIL***#* 
**»#COMPIL***** 
»**»C0MP I L***** 
♦*«*»COMPIL*»*** 
»innfCOMPIL*»»»» 
*inniCOMPIL**»** 
*-»-***COMP  IL»**** 
***«»COMPIL»**** 
****COMPIL**-*»* 
ir*innfCOMP  IL**»*-» 
##-)nnfCOMPIL-»**** 
»#**COMP IL***** 
♦ •nm-COMP  IL*»*** 
**##-»COMP  IL^^*■*^n^ 


REPORTYPE= ! 5 
REPORT  # 1 » 

W1DTH= ' 09 
COLUMNS = ! 03 
LINES= !4 
LINCOUNT= 100 
MAXLINES= !66 
ACCURACY = ! 0 
SCALE  =!1000 
PAGE=‘00 
OUTPUT = ! 14 
COMMAND= ! 9 
ACTIVITY= ! 20 
THIR=  ! I 
SFACING= !01 
YEAR=  ! 0 
MONTH= ! 03 


REPORT  TYPE 


5 


#**«COMPIL##**-»  •»##•»•*■»*»■»■»#■» 

♦♦*#RDPARM##***  PARAMETER  SPECIFICATION  ERROR 


YEAR  ALLOWED  MINIMUM=  75 

ALLOWED  MAXIMUM=  S5 

SPECIFIED  VALUE=  0 

STANDARD  DEFAULT^  76f  USEDf  EXECUTION  CONTINUING 
«##*#GETDAT»****  NRG  7503  FY75  SEP  C 

#*##GETDAT#*##*  NRG  7T03  FY7T  SEP  C 

*#»»COMPIL*#'**-»  C1=A 
#****COMPIL*###'*  C2  = E 


*##»COMPIL****»  C3=A-B 
*##»RDTTTL#***#  CUMdAMTeiST  QTR(31975@ 
»#**»RDTITL»****  CUM(3AMT@1ST  QTRl3197T(i 
♦####RDTITL*»#**  @ e dVARIANCE 
»***COMPIL*#***  DD=S200/8260* ! 100  'PERCENT  FUEL  OIL 


**»»FPDREP*****  END  OF  REPORT  PROCESSING 
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;report  type  line 

; PARAMETER  LINES 


{COLUMN  SPECIFICATIONS 

{COLUMN  TITLES 

OF  TOTAL' 


I 


SAMPLE  4 

INPUT  FILE  FOR  TYPE  IT  REPORT 


REPORTYPE= ! 1 1 
OUTPUT=  ! 14 
COLUMNS= !04 
LINES= !03 
ACCIJRACY  = !03 
SCALE  =11000 
PAGE=  !0 
COMMAND= ! 02 
WIDTH= !8 
SPACING= !01 
YEAR= ! 78 
MONTH= ! 07 
STUB=!9 
*♦#*■**♦■»**•«•* 

SAMPLE  OF  TYPE  11 

NRG  7703C 

NRG  7612C 

NRG  7512C 

0999 

C1=A 

C2  = C 

C0L3=B 

VAR  = A-B 

@30  DEC@1976@ 

@30  .JUN@  19750 
@30  JUN@ 19760 
eCOST  VAR0C1-C3@ 

COMP 

8200/8205  'FUEL  OIL  C03T/MBTU' 
0999 


;SEND  THE  REPORT  TO  L.U.  14 

;3  LINES  IN  COLUMN  TITLES 
;3  DECIMAL  PLACES 
fNUMBERS  IN  THOUSANDS 

rALL  ORGANIZATIONS  IN  DIVISION  2 

fSINGLE  SPACE 

;R0W  labels  up  to  36  CHARS. 

; INDICATES  END  OF  GIVEN  TIME  PERIODS 


sample  4 

REPORT  GENERATED  BY 
TYPE  11  INPUT  FILE 


DATE:04/10/78  PAGE  1 

NCD-5  REPORT  GENERATOR 

SAMPLE  OF  TYPE  11 

FOR  PERIOD  ENDING  30  APRIL  1978 

(AMOUNTS  IN  THOUSANDS) 


FUEL  OIL  COST/MBTU 

30  DEC 
1976 

30  JUN 
1975 

30  JUN 
1976 

COST  VAR 
C1-C3 

NARMC  PENSACOLA 

19.200 

0.000 

30.049 

-10.849 

NTTC  PENSACOLA 

9.138 

0.000 

7.117 

2.021 

PWC  PENSACOLA. 

HSG 

0 . 000 

0.000 

0.255 

-0.255 

PWC  PENSCACOLA. 

CONS 

0.172 

0 . 000 

0.077 

0.095 

NARF  PENSACOLA 

12.319 

0.000 

17.552 

-5.233 

NETPDC  ELLYSON 

FIELD 

0 . 000 

0.000 

0.000 

0 . 000 

NRDC  PENSACOLA 

0.041 

0.000 

0.034 

0.007 

NAS  PENSACOLA 

12.036 

0 . 000 

8.764 

3.272 

PWC  PENSACOLA. 

HSG 

0.412 

0.000 

0.000 

0.412 

PWC  PENSACOLA. 

SHIP 

0.237 

0.000 

0 . 220 

0.017 

PWC  PENSACOLA. 

PERF 

53.555 

0.000 

64.068 

- 10.513 

SAMPLE  4 

MESSAGES  OUTPUT  TO  UNIT  15 


'>****FPD001»****  SYMBOL  TABLE  STORAGE  BEGUN 
♦#**FPD00H»****159  ACTIVITY  NAMES*  UICS*  KEYS 
♦«***FPD001*****  52  FPD  ACCOUNT  SYMBOLS*  NAMES 
♦»**n*FPD001*##»»  SYMBOL  TABLE  STORAGE  COMPLETE 


innnnfCOMPIL**#**  REPORTYPE=  ! 1 1 

♦ iumFPDREP*****  REPORT  # i*  REPORT  TYPE  11 
♦***COMPIL**** » OUTPUT= ! 14 

#***n*COMPIL***«-»  COLUMNS='04 

♦ *nnn*COMPIL»*#*»  LINE3=!03 

♦ ♦**COMPIL###**  ACCURACY  = ! 03 
.♦♦■s^COMPlL*****  SCALE  =!1000 

♦ ♦♦•fUfCOMPIL##-***  PAGE=!0 
•^nn^*COMPIL»^^■»^n^  COMMAND=!02 
♦***COMPIL*****  WIDTH=!8 

♦♦♦♦♦COMPIL**###  SPACING=!01 
'*nnn*COMPIL***#*  YEAR=!78 
*nn**COMPIL***#*  MONTH=!07 

♦ ♦♦♦♦COMPIL****-*  STUB=!9 
*«inn*COMP I L *###•»##»#•**# 


#***GETDAT**'*'»'» 

NRG 

7703 

FY77 

SEP 

c 

..  »-)nn*GETDAT**»#* 

NRG 

7612 

FY76 

JUN 

c 

•»♦•**»  GET  DAT 

NRG 

7512 

FY75 

JUN 

c 

*-»*-*COMP IL*****  C1=A 
**-»*COMPIL****»  CZ  = C 
»#-»»*COMP IL##-**-*  C0L3  = B 
- »»**COMPIL»**»-»  VAR  = A-B 
**-*-*RDTI  TL####*  <?30  DEC@1978fl 
*»hhh*RDTITL»*»**  @30  .JUN@1975e 
###**RDTITL#**-»*  @30  .JUN@1978@ 

*#»»RDTITL****-»  eCOST  VAR@C1-C3@ 
****COMPIL»#*»»  8200/8205  'FUEL  OIL  COST/MBTU' 


JSEND  THE  REPORT  TO  L.U. 

13  LINES  IN  COLUMN  TITLE 
*3  DECIMAL  PLACES 
•NUMBERS  IN  THOUSANDS 

•ALL  ORGANIZATIONS  IN  DI 

•SINGLE  SPACE 

;R0W  labels  up  to  36  CHAR 


♦innnfFPDREP*****  END  OF  REPORT  PROCESSING 
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DEVELOPMENT  OF  MINIGAP  INPUT  FILE 


The  following  questions  should  be  ansv;ered  before  attempting  to  develop 
an  input  file  for  a report; 

1.  What  report  type  is  desired  (2,  4,  5 or  11)?  See  "Structure  of 
Report  Requests"  to  determine  which  report  type  to  use. 

2.  What  time  period/s  is/are  involved?  This  is  specific  to  your 

data. 


3.  What  organization  is/are  involved?  This  is  specific  to  your 

data.  (See  "Parameters,"  Level  1,  Level  2 and  Level  3,  and  determine  what  values 
these  parameters  should  contain.) 

4.  What  account/s  is/are  involved?  This  is  specific  to  your  data. 

5.  Are  any  computations  necessary?  If  so,  what  are  they? 

Now,  you  are  ready  to  create  a MINIGAP  input  file.  Consult  "Structure  of 
Report  Requests"  to  determine  the  line  types  necessary,  and  their  order,  for 
the  chosen  report  type.  Consult  "Parameters"  to  decide  which,  if  any,  para- 
meters are  necessary,  and  what  values  they  should  be  assigned.  Consult 
"Syntactical  Requirements"  to  determine  the  exact  format  to  be  used  for  each 
line  type. 

It  may  also  be  helpful  to  check  the  sample  input  file  for  the  desired 
report  type,  in  the  last  section,  "Samples". 


INDEX 


Account  end,  see  Line  type. 

Accounts,  see  Line  type. 

Accuracy,  see  Parameter  words. 

ACTI,  see  Parameter  words. 

ALPHA,  see  Syntax  key. 

BLANK,  see  Syntax  key. 

Column  specifications,  see  Line  type. 
Column  title,  see  Line  type. 

Columns,  see  Parameter  words. 

COMM,  see  Parameter  words. 

Commas,  see  Parameter  words. 
Computations,  see  Line  type. 

Constant,  a number  preceded  by  an 
exclamation  point. 

Development  of  Input  file,  A-1. 
Diagnostic  messages,  1-1. 

Driver  file,  1-1 . 

Formatting,  see  Line  type. 

FORMULA,  see  Syntax  key. 

GAP. CSS,  1-2. 

General,  1-1. 

Input,  see  Parameter  words. 

Input  end,  see  Line  type. 

Input  parameters,  see  Parameters. 
INTEGER,  see  Syntax  key. 

Length,  see  Parameter  words. 

Level  1,  see  Parameter  words. 

Level  2,  see  Parameter  words. 

Level  3,  see  Parameter  words. 

Line  type,  a line  with  a specific 

syntax  and  meaning,  used  to 
describe  the  user  input  file. 
Account  end,  4-16. 

Accounts,  4-14. 

Column  specifications,  4-11. 

Column  title,  4-12. 

Computations,  4-15. 

Formatting,  4-13. 

Input  end,  4-6. 

Report  title,  4-7. 

Report  type,  4-4. 

Time  period,  4-8. 

Time  period  end,  4-9. 

Lines,  see  Parameter  words. 


Master  file,  1-1 . 

Maxlines,  see  Parameter  words. 

Month,  see  Parameter  words. 

NUMBER,  see  Syntax  key. 

Output,  see  Parameter  words. 

Page,  see  Parameter  words. 

Parameter  word,  a word  referenced 

by  a specific  set  of  characters, 
with  a specific  meaning,  which 
the  user  can  specify  to  define 
the  report  generation  process; 
redefining,  2-2. 
syntax,  4-5. 

Mjrds:  Accuracy,  3-2. 

ACTI,  3-2. 

Columns,  3-2. 

COMM,  3-3. 

Commas,  3-4. 

Input,  3-3. 

Length,  3-4. 

Level  1,  3-2,  3-5. 

Level  2,  3-3,  3-5. 

Level  3,  3-3,  3-5. 

Lines.,.3-2. 

Maxlines,  3-3. 

Month,  3-2. 

Output,  3-4. 

Page,  3-3. 

Pune,  3-4. 

Scale,  3-3. 

Spacing,  3-2. 

Stub,  3-4. 

THIR,  3-3. 

Width,  3-4. 

Year,  3-2. 

Parameters,  1-1,  3-1/3-5,  see 
Parameter  words. 

Partition  size,  1-1. 

PUNC,  see  Parameter  words. 

QUOTE,  see  Syntax  key. 

REP002,  description,  2-2. 
samples,  5-3/5-5. 
structure  of  input,  2-4. 

REP004,  description,  2-2. 
samples,  5-6/ 5-8. 
structure  of  input,  2-4. 
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REP005,  description,  2-2. 
samples,  5-9/5-11 
structure  of  input,  2-5. 

REP011,  description,  2-2. 
samples,  5-12/5-14. 
structure  of  input,  2-5. 

Report  type,  2-2,  see  Parameter  words. 

Samples,  5-1/5-14. 

REP002,  5-3/5-6. 

REP004,  5-6/5-8. 

REP005,  5-9/5-11. 

REP011,  5-12/5-14. 

Scale,  see  Parameter  words. 

SEPARATOR,  see  Syntax  key. 

Size,  see  Partition. 

Spacing,  see  Parameter  words. 

STRING,  see  Syntax  key. 

Stub,  see  Parameter  words. 

Syntax  key,  4-3. 

THIR,  see  Parameter  words. 

Variable,  any  string  of  alpha-numeric 
characters,  which  is  not  an 
account  code,  a constant,  or  a 
parameter  word. 

Width,  see  Parameter  words. 

Year,  see  Parameter  words. 
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